ДокументDOM.ИмпортироватьУзел (DOMDocument.ImportNode)

ДокументDOM (DOMDocument)

ИмпортироватьУзел (ImportNode)

Доступен, начиная с версии 8.1.

Синтаксис:

ИмпортироватьУзел(<Узел>, <Рекурсивно>)

Параметры:

<Узел> (обязательный)

Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.
Импортируемый узел DOM.

<Рекурсивно> (обязательный)

Тип: Булево.
Признак "глубокого" импортирования.
Истина - будут рекурсивно импортированы все дочерние узлы импортируемого узла. Исключения составляют узлы Атрибут и СсылкаНаСущность.
Для Атрибут дочерние узлы импортируются всегда.
Для СсылкаНаСущность дочерние узлы не импортируются.
Ложь - импортируется только переданный узел.

Возвращаемое значение:

Описание:

Импортирует узел из другого документа DOM в данный.
Для каждого узла импортируются свойства ТипУзла, ИмяУзла, а также свойства, относящиеся к пространствам имен: ЛокальноеИмя, Префикс, URIПространстваИмен. Пользовательские данные не переносятся.
Правила импорта для типов узлов:

Атрибут - ЭлементВладелец устанавливается в Неопределено, признак Указан устанавливается в Истина, импортируются все потомки узла;
ФрагментДокумента - если признак "глубокого" импортирования установлен, то все потомки фрагмента рекурсивно копируются в новый фрагмент, в противном случае просто создается пустой узел ФрагментДокумента;
Документ - не может быть импортирован;
ОпределениеТипаДокумента - не может быть импортирован;
Элемент - атрибуты с установленным свойством Указан импортируются, для нового узла-элемента создаются атрибуты, имеющие значения по умолчанию;
Сущность - узлы могут быть импортированы, даже если документ находится в режиме Только для чтения. Свойства ПубличныйИдентификатор, СистемныйИдентификатор и ИмяНотации копируются;
СсылкаНаСущность - импортируется только данный узел. Если в данном документе определена сущность с таким же именем, то формируется значение сущности для импортированной ссылки;
Нотация - узлы могут быть импортированы, даже если документ находится в режиме Только для чтения. Свойства ПубличныйИдентификатор, СистемныйИдентификатор копируются;
ИнструкцияОбработки - копируются свойства Цель и Данные;
Текст, СекцияCDATA, Комментарий - копируются свойства ТекстDOM.Данные, КомментарийDOM.Данные, СекцияCDATADOM.Данные и ТекстDOM.Размер, КомментарийDOM.Размер, СекцияCDATADOM.Размер.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Примечание:

Причины вызова исключений:

импортируемые имена содержат символы, недопустимые стандартом XML данного документа.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация